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FOREWORD 


The Software Engineering Laboratory (EEL) is an organization 
sponsored by the National Aeronautics and Space Administra- 
tion/Goaaara Space Flight Center (NASA/GSFC) and created for 
the purpose of investigating the effectiveness of software 
engineering technologies when applied to the development of 
applications software. The SEL was created in 1977 and has 
three primary organizational members: 

NASA/GSFC (Systems Development and Analysis Branch) 

The University of Maryland (Computer Sciences Department) 
Computer Sciences Corporation (Flight Systems Operation) 

The goals of the SEL are (1) to understand the software de- 
velopment process in the GSFC environment; (2) to measure 
the effect of various methodologies, tools, and models on 
this process; and (3) to identify and then to apply success- 
ful development practices. The activities, findings, and 
recommendations of the SEL are recorded in the Software En 
gineering Laboratory Series, a continuing series of reports 
that includes this document. 

The primary contributors to this document are 

John Buell (Computer Sciences Corporation) 

Philip Myers (Computer Sciences Corporation) 

Single copies of this document can be obtained by writing to 

Frank E. McGarry 
Code 552 
NASA/GSFC 

Greenbelt, Maryland 20771 
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ABSTRACT 


A sample development scenario using the Flight Dynamics Sys- 
tem Software Development Environment (FDS/SDE) is presented. 
The SDE uses a menu-driven, f ill- in-the-blanks format that 
provides online help at all steps, thus eliminating lengthy 
training and allowing immediate use of this new software 
development tool. 
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SECTION 1 - INTRODUCTION 

The Flight Dynamics System Software Development Environment 
(FDS/SDE) provides an exciting new method for developing 
software. It uses a menu-driven, f ill-in-the-blanks format 
that permits the developer to input, edit, compile, link, 
and execute software. Online help is always available, thus 
eliminating a lengthy training period and allowing immediate 
use of this new tool. 

This tutorial demonstrates the use of the SDE following this 
simple eight-step scenario: 

1. A software developer logs on to the IBM timesharing 
system (TSO) and enters the SDE (pages 3-2 through 
3-14) . 

2. An IBM job card is formatted (pages 3-15 through 
3-21) . 

3. A main program and two subroutines are entered into 
an existing PANVALET library (pages 3-22 through 
3-49) . 

4. The program and subroutines are compiled with the 
IBM VS FORTRAN compiler to produce object modules 
(pages 3-50 through 3-74) . 

5. The object modules are merged together (link edited) 
into an executable program (load module) (pages 3-75 
through 3-88) . 

6. The executable program is run (pages 3-89 through 
3-97) . 

7. All listing files are sent to a printer for output 
(pages 3-98 through 3-105) . 
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8. 


The developer updates the SDE analysis log, exits 
the SDE, and loas off TSO (pages 3-106 through 
3-109) . 


At the beginning of the tutorial, each step of the devel- 
oper's actions is shown on a separate paqe to highlight the 
specific action being taken. Later, all actions taken by a 
developer before pressing the <enter> key are shown on 
the same page. Shaded areas denote the changes from panel 
to panel (display to display) . The underscore character in 
some of the shaded areas is not typed in; it simply marks 
the current cursor position as it actually appears on the 
screen . 

The SDE has many more functions that aid the developer to 
create programs. All the capabilities of the Interactive 
System Productivity Facility (ISPF) are detailed in Refer- 
ence 1. Reference 2 explains the use of all SDE functions 
that have been added to the basic ISPF. 
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SECTION 2 - BASIC SDE TERMS AND CONCEPTS 


Before beginning the tutorial, a few basic terms and concepts 
of ISPF processing must be explained. The terms--panels , 
commands, help, and messages--ana the concepts--levels , nav- 
igation, and jumps--are used extensively in discussions of 
ISPF and the SDE. Brief descriptions of the 327x keyboard 
and display screen and the ISPF editor (used in the scenario 
to create FORTRAN source modules) are also presented. 

2.1 SDE TERMS 

• Panels--Four basic types of panels are used in the 
tutorial, although more are available on the ISPF. 

Selection panels display a list of options in 
a menu format along with an associated option 
code. The selected option code is entered in 
a field near the top of the screen that dis- 
plays OPTION== => . 

- Parameter entry panels are reached after se- 
lections have been made. Parameters for a 
specific function, such as file names or list- 
ing options, are entered on these panels. 

Data entry panels are used almost exclusively 
by the editor. They allow data to be input to 
the computer. 

Help panels provide instructions on how to use 
a specific function. 

• Commands — ISPF and SDE commands (print, down, up, 
etc.) can be entered in the parameter entry field next to 
the COMMAND===> or OPTION===> prompts. The ISPF tutorial 
(Option 8.T) explains all commands. 
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• Help--Help is available online, pertinent to what- 
ever panel is being displayed, whenever needed. Help is 
ootained by pressing program function key 1 <PF1> or by 
typing "help" next to the COMMAND===> or OPTION===> 
prompt . 


• Messages--Messages are displayed in short and/or 
long format. The short format always appears in the upper 
right corner of the display. A long message, which further 
explains the short message, is displayed when <PF1> is 
pressed. When a short message is being displayed, help is 
obtained by pressing <PF1> twice {once to get the long 
message, once more for the help panel). 


2.2 SDE CONCEPTS 


• Levels--The SDE may be visualized as 
structured environment. The primary panel is 
which has major branches. Each branch can in 
branches, depending on how many subselections 
For example, 


a tree- 
the trunk, 
turn have more 
are available. 


Primary 

Option 

Panel 



Translation 



Compile Compile 
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• Navigation — Navigation through the SEE (traversing 
the tree) is achieved by selecting codes displayed next to 
the various options on each selection panel* 

• Jumps--Random access to option nodes can be achieved 
by entering an equal sign (=) ana an option sequence in any 
parameter entry field, bypassing the intermediate option 
selections. This capability is demonstrated in scenario 

step 5. 

2 . 3 3 27x KEYBOARD AND DISPLAY SCREEN 

The keys on the 327x-type terminals are used to facilitate 
the use of ISPF and SDE functions. Table 2-1 describes the 
hardware keys usea on the 327x keyboard. Table 2-2 describes 
the default program function (PF) keys used by the ISPF, as 
defined for this tutorial; they can be changed using op- 
tion 0. The text symbol is used throuahout the scenario to 
specify a particular key. The keyboard symbol varies 
slightly among 327x terminals made by different manufac 
turer s . 

The displays presented in the sample development scenario in 
Section 3 are surrounded by a facsimile of a 327x display 
screen. The lower portion of each display is the 327x sys- 
tem status area. Table 2-3 describes the symbols that may 
be displayed in this status area throughout the scenario. 

2.4 ISPF EDITOR 

The sample development scenario uses the ISPF editor to cre- 
ate FORTRAN source modules. Before beginning the scenario, 
a few basic editor commands should be explained. The ISPF 
eaitor is designed to take advantage of the capabilities oj. 
the 3 27x- type display devices. These devices transmit and 
receive data in block mode, meaning that data are transmit 
ted to and from the computer in large, screen-size blocks. 


2-3 


0253 



Table 2-1. Hardware Keys 


Keyboard Text 
Key Name Symbol Symbol 


Purpose 


Alt 

ALT 

<alt> 

Backward 

H 

<BT > 

tab 

Forward 

N 

<FT> 

tab 

New line 


<NL> 

Home 

\ 

<home > 

Cursor 

CURSOR 

<csel > 

select 

SEL 


Clear 

CLEAR 

<cls> 

screen 

Erase EOF 

ERASE 

EOF 

<EEOF > 

Arrow keys 

U- 

- 

Enter 

ENTER 

<enter 

Insert 

a 

<ins> 

Delete 

/ 

<del> 

Reset 

RESET 

<res > 


Used to perform any function il- 
lustrated on the front of keys 

Moves the cursor left to the 
previous entry field 

Moves the cursor right to the 
next entry field 

Moves the cursor down to the 
next entry field 

Moves the cursor to the first 
data entry field on the top 
left (alternate function of 
forward tab) 

Toggles the cursor between a 
box and an underscore charac- 
ter 

Clears the entire display area 
and positions the cursor in 
the top left of the screen 
(alternate function of cursor 
select) 

Erases all characters from the 
cursor position to the right edge 
of a data entry field 

Moves the cursor up/down/left/ 
right one position, not to next 
entry field 

Transmits all information 
entered to computer 

Puts screen into insert mode; 
characters typed will not 
overwrite those characters 
already displayed on the 
screen (see <res>) 

Deletes character displayed at 
the current cursor position 

Takes the terminal out of insert 
mode and unlocks the keyboard 
after an illegal action has been 
flagged (when the stick figure 
can be seen in the status area) 
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Table 2-2. Program Function Keys 



Keyboard 

Text 

Key Name 

Symbol 

Symbol 

Help 

PF1 

<help> 


Split 

screen 

PF2 

<split > 

End 

PF3 

<end > 

Return 

PF4 

<rtn> 

Find next 

PF5 

<f nxt > 

Replace 

Next 

PF6 

<rnxt > 

Scroll Up 

PF7 

<up> 

Scroll 

down 

PF8 

<down> 

Swap 

PF9 

<swap> 

Scroll 

left 

PF10 

<lef t > 

Scroll 
r ight 

PF11 

<r ight > 

Cursor 

PF12 

<c r s r > 


Purpose 

Displays a long message if a 
short message is being dis- 
played; displays a help panel 
if no message is present or 
if pressed a second time 
while a message is being dis- 
played 

Splits the screen into a sec- 
ond copy of ISPF/SDE at the 
current cursor position 

Ends the current display 

Returns to the primary option 
panel 

Finds next occurrence of a 
pattern in edit or browse 

Replaces next occurrence of a 
pattern in edit only 

Moves the display window up 

Moves the display window down 

Moves the cursor to the oppo- 
site window 

Moves the display window to 
the left 

Moves the display window to 
the right 

Moves the cursor to the top 
left entry position in the 
current window 
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Table 2-3. System Status Area Symbols 


Name 

Symbol 

Meaning 

Clock 

0 

Wait 

System 

Stick 
f igure 

SYSTEM 

X 

CPU is processing last request 

Something was typed in an area of the 
display that is not a valid input area; 
press the <res> key to recover from this 
problem; use the <FT>, <BT>, or <NL> keys 
to move the cursor into an input area 

caret 

Caps 

lock 

/V 

t 

Insert mode is turned on 

The <caps lock> key has been pressed 
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The 3 27x device processes information displayed on the 
screen and modifies it until the user presses <enter>. At 
that time, the screen is transmitted to the computer, a re- 
sponse is received from the computer, and the screen is re 
written. 

The ISPF editor has the capability to insert, delete, move, 
copy, and sort single lines or blocks of lines anywhere in a 
file, at the discretion of the developer. A few basic edit- 
ing capabilities are described below. The developer is, 
however, urged to use the online help available to learn all 
of the editor's capabilities. 

• Inserting character s--To insert a character, press 
the <ins > key on the keyboard (note the ^ in the status 
area) , position the cursor on the screen where characters 
are to be inserted, and begin typing. Characters to the 
right of the cursor will be pushed to the right as new char- 
acters are inserted. If pushing the characters would make 
the one on the far right of the line go off the screen, the 
keyboard will lock. Press <res> to recover. Then use the 
<r ight > key to move the display window so that inserted 
characters ana the moving characters are in the display area. 

If the editor will not allow characters to be inserted when 
there are apparently no characters on the line (it displays 
the stick figure and clicks when any key is struck) , it is 
trying to shift blank characters to the right while new 
characters are being typed. This can be remedied either by 
moving the cursor to the right of the last nonblank charac- 
ter on the line and pressing <EEOF> or by typing "nulls on" 
in the command line area. "Nulls on" tells the editor to 
pad empty lines with null characters instead of blanks. 
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• Changing a character--To change a character, simply 
position the cursor on top of the character to be .changed 
and type over it. If insert mode is on ( /N is in the status 
area), press <res> to turn it off. 

• Deleting character s--To delete a character, posi- 
tion the cursor on the character to be deleted and press the 
<del> key. All characters on the right of the cursor will 
be shifted to the left by one column. 

• Moving a line--To move a line, mark the destination 
by typing an "a" or "b" on the line number the line is to be 
moved after (a) or before (b) , and mark the source by typing 
an " m " on the line to be moved. Press <enter>, and the line 
marked with an "m" will be moved. 

• Copying a line--To copy a line, mark the destina- 
tion by typing an "a" or "b" on the line number the line is 
to be copied after (a) or before (b) , and mark the source by 
typing a "c" on the line to be copied. Press <enter>, and 
the line marked with a "c" will be copied. 

• Deleting lines--To delete lines from a file, move 
the cursor into the left side of the display with the <NL> 
key. Position it on each line number you want to delete, 
and type a "d" to mark it. After all lines to be deleted 
have been marked, press <enter> and all the lines marked 
will disappear from the file. 

• Inserting a line--To insert a new line in a file, 
move the cursor into the numbered area of the display with 
the <NL> key. Position it on the line number the new line 
is to be inserted after, and type an "i". Press <enter>, 
and a line with a row of dots in the line number area will 
appear. Position the cursor where desired with the <arrow> 
keys, and type in tine new line. When <enter> is pressed, 
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a no the r row of aots will appear a nd the process can be re 
peatea. The line insertion process ends when <enter> is 
pressed but nothing is typed. 

• Inserting many lines--To insert many new lines in a 
file, move the cursor into the numbered area of the display 
with the <NL> key. Position it on the line number the new 
lines are to be inserted after and type an "i<n>", where 
<n> is the number of lines to be inserted. Press <enter>, 
and <n> rows of dots will appear in the numbered area. Posi 
tion the cursor where desired with the < arrow > keys, and 
type in the new inf orrnation. 

• Displaying next page of file--To display the next 
page of a file, press <PF8> or type "down" in the command 
line input area. 

• Displaying previous page of file--To display the 
previous page of a file, press <PF7> or type "up" in the 
command line input area. 
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SECTION 3 - SAMPLE DEVELOPMENT SCENARIO 


Step one of the scenario requires logging on to TSG. The 
procedure differs depending on whether the terminal is con- 
nected directly to the FDF 3 at Goaaard Space Flight Center 
(GSFC) or is connected through a modem. Most of the 
327x terminals connected to the FDF3 at GSFC are direct- 
connect terminals. Developers using these terminals should 
begin the scenario on page 3-2. Developers using terminals 
that are connected to the FDF3 through a modem should begin 
the scenario on page 3-4. 
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Scenario Step 1: Logging on TSO and entering SDE 



This Is what will appear on the top line of the terminal before you log on to 
the 4341 computer. If the terminal that you want to use does not display the 
request seen above, press and hold the <alt> key and the <csel> key. This 
performs the alternate function of that key, which is cl ear-screen . If you 
still don't get the request message, tell your^ supervisor. 
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Scenario Step 1: Logging 


on TSO and entering SDE 



Type in your user identifier (userid), sponsor code, and project 
get this Information from your supervisor. The userid, sponsor, 
codes above are gjzzp, spons , and test, respectively. 


code. You can 
and project 


Press <enter>. the screen will clear. . . • 


(go to page 3-10) 
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Scenario Step 1: Logging on TSO and entering SDE 



This panel is displayed before any action is taken at the terminal. It is 
called the VM prompt panel, or the logo panel, and indicates the terminal is 
connected to the Flight Dynamics Facility ( FDF ) computer system. There are 
currently three computers in the FDF, referred to as the FI, F2, and the F3. 
The Software Development Environment (SDE) is only Installed on the F3, The 
first action to take Is to connect the terminal to the F3 computer. This is 
done by pressing the <enter> key . . . 
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Scenario Step 1: Logging on TSO and entering SDS 



... and this panel is displayed, indicating the terminal is connected to the 
FI computer ('F0F-F1VM' is displayed in the lower right corner). 

Next we type in . . . 
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Scenario Step 1: Logging on TSO and entering SDE 



'dial mvs', then press <enter>, to use the MVS operating system. 
The screen will clear . . . 
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Scenario Step 1: Logging on 


TSO and entering SDE 



'DIAL TO MVS' is repeated at the top left corner of the screen 
and three hexadecimal digits appear briefly two lines lower on 


'DIALED TO MVS' 
the screen; the 


screen clears again, and 
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Scenario Step 1: Logging on TSC and entering SDE 



. . . this message appears on the top line of the terminal, indicating the 

terminal Is connected to the FI computer under the MVS operating system. 

A special logon command, L0G0NF3 , switches the terminal from the FI to the F3 


computer . 


Scenario Step 1: Logging 


on TSO and entering SDE 



Type in L0G0NF3 , your user identifier (userid), sponsor code, and project code 
you can get this information from your supervisor. The userid, sponsor, and 
project codes aoove are gjzzp, spons . and test, respectively. 

Press <enter>, the screen will clear, . . . 
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Scenario Step 1: Logging on TSO ana entering SDE 



and this message is displayed briefly after the logon command has been 
accepted. In a short time the screen will clear again, and . . . 
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Scenario Step 1: Logging on TSO and entering SDE 



. you are prompted for your TSO password. Type it in. The letters you 

type win not De displayed. Press <enter> when you have finished; in a few 

seconds . . - 
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Scenario Step 1: Logging on TSO and entering SDE 



. these messages will appear. The time and date will differ from the ones 
shown here, and there may be some downtime scheduled to maintain the F3 computer 
system, but this basic format will be displayed. 

We have successfully logged on to TSO and now must enter the software 
development environment. To do this, . . . 
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Scenario Step 1: Logging on TSO and entering SDE 



type in the command above and press <ent_er^. In a few moments 
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Scenario Step 1: Logging on TSO and entering SDE 



It is called the primary option panel and lists all of the major options 
available to the SDE developer. The underscore character in the upper left is 
only marking the current cursor position, it never has to be typed in. In order 
to perform step 2 of our scenario, we have to define an IBM job card. Job cards 
are used to provide accounting information and several other types of 
information used to process background jobs. 
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FDS/SDE PRIMARY OPTION MENU VERSION 2.2 


OPTION 




0 DEFAULTS 


USERID - GJ2ZP 

TIME - 13:25 

- Specify terminal ana user parameters TERMINAL - 3278 

- Display source data or output listings PF KEYS - 24 

- Create or change source data 

- Perform utility functions (copy, allocate, rename, list) 

- Invoke language translators (Asm, Fort, Pascal, GESS) 

- Invoke linkage-editor (build load modules) 

- Enter TSO command or CLIST 

- Perform dialog testing 

- Display news or enter comments about ISPF/POF/SDE 

- Use on-line management information systems 

- Miscellaneous Software Development Environment Features 

- Direct Access data handling utility 

- Using SPOOL Display and Search Facility (SDSF) 

- Update SDE/SEL Data Base log with ISPF log data 

- Browse, edit, and utilities for Panvalet data sets 

- Terminate ISPF using log and list defaults 


Enter END command to terminate ISPF. 


Type a 0 in the option selection field to select DEFAULTS and press the <enter> 
key . 
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Scenario Step 2: Defining IBM Job Caro 



The FDS/SDE parameter options selection panel is displayed 
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Scenario Step 2: Defining IBM Job Card 



Type in JC to select the job card option, press <enter', and 
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Scenario Step 2: Defining IBM Job Card 



. . the parameter entry panel for tne change job card function is displayed. 

The actual job cards displayed at the bottom may differ on your display the 
first time you enter this function. In a moment they will be very similar. 
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Scenario Step 2: Defining IBM Job Card 



Pressing <help> will let you read the help panels associated with this function 
They explain the various fields and the values that could be entered. Rather 
than get bogged down with details, use the values for each field as they appear 
on this panel. <FT> to move the cursor from input field to input field. 

Press <enter>, and . . . 
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Scenario Step 2: Defining IBM Job Card 



displayed as a valid MVS job card. The short message 'JOB CARDS GENERATED' 
appears in the upper right corner of the screen. 

Silver Spring developers should use FFF instead of CCC , and PRTSS instead of 
PRT23; your actual sponsor code and project ID will vary; these are fictitious, 

When satisfied that the j ch card is correct, press <end> and . . . 
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Scenario Step 2: Defining IBM Job Card 



. we will go up one level to the DEFAULTS selection panel. Press <end> 
again and . . . 


3-21 




Scenario Step 3: Creating/Editing Panvalet member 


FDS/SDE PRIMARY OPTION MENU VERSION 2.2 


OPTION =**> 


USERID - GJZZP 


- 14:55 


0 DEFAULTS - Specify terminal and user parameters TERMINAL - 3278 


1 BROWSE 


Display source data or output listings PF KEYS - 24 


2 EDIT 


- Create or change source data 


3 UTILITIES - Perform utility functions (copy, allocate, rename, list) 


4 COMPILE 


Invoke language translators (Asm, Fort, Pascal, GESS) 


5 LINK 


- Invoke linkage-editor (build load modules) 


6 TSO 


- Enter TSO command or CLIST 


7 TEST 


- Perform dialog testing 


8 NEWS/VIEWS * Display news or enter comments about ISPF/PDF/SDE 


9 MGT INFO 


Use on-line management information systems 


10 MISC 


- Miscellaneous Software Development Environment Features 


F FILE AID - Direct Access data handling utility 
JS JOB STATUS - Using SPOOL Display and Search Facility (SDSF) 


L LOG 


P PANVALET 


X EXIT 


- Update SDE/SEL Data Base log with ISPF log data 

- Browse, edit, and utilities for Panvalet data sets 

- Terminate ISPF using log and list defaults 


Enter END command to terminate ISPF. 



. . . we are back at the primary option panel. 

In order to perform step 3 of our scenario, we have to create a FORTRAN 
main routine in a Panvalet library. To do this, we should ... 
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Scenario Step 3: Creating/Editing Panvalet member 


OPTION = = k> ;.:F^ 


JS JOB STATUS 


FDS/SDE PRIMARY OPTION MENU VERSION 2.2 “ 

USERID * GJ2ZP 

TIME ' 14:55 

Specify terminal and user parameters TERMINAL - 3278 
Display source data cr output listings PF KEYS ~ 24 
Create or change source data 

Perform utility functions (copy, allocate, rename, list) 

Invoke language translators (Asm, Fort, Pascal, GESS) 
Invoke 1 i nkage - ed i t or (build load modules) 

Enter TSO command or CLIST 
Perform dialog testing 

Display news or enter comments about ISPF/PDF/SDE 
Use on-line management information systems 
Miscellaneous Software Development Environment Features 
Direct Access data handling utility 
Using SPOOL Display and Search Facility (5DSF) 

Update SDE/SEL Data Base log with ISPF log data 
. Browse, edit, and utilities for Panvalet data sets 
■ Terminate ISPF using log and list defaults 


Enter END command to terminate ISPF. 


type option 'P' and Dress the <enter> key, which . . . 
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Scenario Step 3: Creat i ng/ Ed i t i ng Panvalet member 



. . . displays the Panvalet function's selection panel. Panvalet is a data 
base management system that specializes in storing source code. It can also 
store data or anything else that can be grouped into 80- character records 
( "card- images H , for trivia buffs) . Each separate entity is referred to as a 
'member' in a Panvalet library. Members can be grouped by using the same first 
two characters as a prefix in a name. 
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Scenario Step 3: C reat i ng/ Ed i t i ng Panvalet member 



Select option 2, edit, and press <enter> . . . 
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Scenario Step 3: Creating/Editing Panvalet member 


PANVALET EDIT PANEL 


COMMAND ■**> 


STANDARD PANVALET LIBRARY: 


VERSION - 10. 4A 


PROJECT 


MEMBER ***> 


(BLANK FOR MEMBER SELECTION LIST) 


NON STANDARD PANVALET LIBRARY: 


PANVALET LIB ***> 


VOLUME SERIAL »«*> 


MEMBER SELECTION LIST OPTIONS: 


(IF NOT CATALOGED) 

WITH COMMENTS *> N (“Y M OR M N" ) 


LIST MEMBERS STARTING WITH ■*«> 
LIST MEMBERS WITH LANG TYPE »*=> 


LIST MEMBERS WITH USER CODE 


LIST MEMBERS WITH STATUS 


NEW MEMBER OPTIONS : 


LANG TYPE •**> 


USER CODE **«> 


(OPTIONAL) 


NOFORMAT 


6 > N (Y OR N) 


PANVALET RETRIEVAL OPTIDNS: 


CONTROL ***> 


ACCESS = *«> 


PROFILE 


PAN/TSO =**> PAN 


EXPAND 


(PAN OR TSO SEQUENCING) 
(Y OR N) 


(DEFAULTS TO MEMBER LANGUAGE TYPE) 


INITIAL MACRO =*=> 



and the Panvalet edit function's parameter entry panel is displayed. This 
panel Is where we 'fill in the blanks' that provide the Panvalet edit function 
with the information it needs to begin processing. 


We are going to create three new members in an existing Panvalet library that is 
named GJ22P . TEST . PAN . If you do not have a Panvalet library, use option 3.2.2 
to create one. 
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Scenario Step 3: Creat i ng/Ed i t i ng Panvalet member 


' PANVALET EDIT PANEL 

COMMAND = = = > 

STANDARD PANVALET LIBRARY: VERSION - 10. 4A 

PROJECT = = * > i£|j 
LIBRARY ***> 

TYPE ***> 

MEMBER = **> (BLANK FDR MEMBER SELECTION LIST) 

NON STANDARD PANVALET LIBRARY: 

PANVALET LIB »**> 

VOLUME SERIAL ***> (IP NOT CATALOGED) 

MEMBER SELECTION LIST OPTIONS: WITH COMMENTS -> N (”Y“ OR "N" ) 

LIST MEMBERS STARTING WITH »«■> 

LIST MEMBERS WITH LANG TYPE *«*> 

LIST MEMBERS WITH USER CODE *"> 

LIST MEMBERS WITH STATUS ***> 

NEW MEMBER OPTIONS: 

LANG TYPE ■»“> 

USER CODE «*«> (OPTIONAL) NOFORMAT — > N (Y OR N) 

PANVALET RETRIEVAL OPTIONS: 

CONTROL --*> PAN/TSO «•■> PAN (PAN OR TSD SEQUENCING) 

ACCESS ***> EXPAND **»> N (Y OR N) 

PROFILE =**> (DEFAULTS TO MEMBER LANGUAGE TYPE) 

l INITIAL MACRO ***> 

V mJ-H " I 


Grouping all members of the same system or subsystem by prefix allows us to 
refer to the group by prefix when using some of the SDE functions. Even though 
this scenario will not use the functions, we'll prefix the component names with 
'TS' (for TeSt). Use the <NL> key to move the cursor to the PROJECT name 
qualifier parameter entry fielo and type in g j ZZ E • • • 


3-27 




Scenario Step 3: Creat i ng/ Ed i t i ng Panvalet member 



Use the <NL> key to move to the LIBRARY parameter entry field and type in 
test . . . 
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Scenario Step 3: Creat i ng/Ed i t i ng Panvalet member 



Use the <NL> key to move to the TYPE parameter entry field and type in 


pan . . . 
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Scenario Step 3: Creating/Editing Panvalet member 


PANVALET EDIT PANEL - 

COMMAND **=> 

STANDARD PANVALET LIBRARY: VERSION - 10. 4A 

PROJECT ***> gjzzp 
LIBRARY ***> test 
TYPE *«*> pan 

MEMBER *«*> (BLANK FOR MEMBER SELECTION LIST) 

NON STANDARD PANVALET LIBRARY: 

PANVALET LIB ***> 

VOLUME SERIAL »**> (IF NOT CATALOGED) 

MEMBER SELECTION LIST OPTIONS: WITH COMMENTS -> N ("Y" OR M N" ) 

LIST MEMBERS STARTING WITH *«*> 

LIST MEMBERS WITH LANG TYPE **=> 

LIST MEMBERS WITH USER CODE ««*> 

LIST MEMBERS WITH STATUS '**> 

NEW MEMBER OPTIONS: 

LANG TYPE ***> 

USER CODE ■««> (OPTIONAL) NOFORMAT *■*> N (Y OR N) ' 

PANVALET RETRIEVAL OPTIONS: 

CONTROL ***> PAN/TSO ** = > PAN (PAN OR TSO SEQUENCING) 

ACCESS *««> EXPAND ***> N (Y OR N) 

PROFILE ***> (DEFAULTS TO MEMBER LANGUAGE TYPE) 

INITIAL MACRO ***> 

^ I *• L-B- i&&3i 


. Press <NL> to move to the MEMBER parameter entry 
prefix and name combination t s samp 1 e . . . 


field and type 


in the 


3-30 




Scenario Step 3: Crea t i ng/Ed i t i ng Panvalet member 



PANVALET EDIT PANEL 

COMMAND *==> 

STANDARD PANVALET LIBRARY: 

PROJECT *=* = > gjzzp 
LIBRARY = = = > test 
TYPE =**> pan 

MEMBER * = *> tssample 
NON STANDARD PANVALET LIBRARY: 

PANVALET LIB ***> 

VOLUME SERIAL ***> 

MEMBER SELECTION LIST OPTIONS: 


BLANK FOR MEMBER SELECTION LIST) 


(IF NOT CATALOGED) 

WITH COMMENTS *> N ("Y" OR "N" ) 


LIST 

MEMBERS 

STARTING ! 

WITH 

* * * > 

LIST 

MEMBERS 

WITH 

LANG 

TYPE 

* * * > 

LIST 

MEMBERS 

WITH 

USER 

CODE 

** *> 

LIST 

MEMBERS 

WITH 

STATUS 

* * * > 


NEW MEMBER OPTIONS : 

LANG TYPE = = *> 

USER CODE **“> (OPTIONAL) 

PANVALET RETRIEVAL OPTIONS: 


CONTROL ***> 
ACCESS *“> 
PROFILE 
INITIAL MACRO 


PAN/TSO 

EXPAND 


NOFDRMAT «**> N (Y OR N) 

c ««> PAN (PAN OR TSO SEQUENCING) 

b**>N (YORN) 


(DEFAULTS TO MEMBER LANGUAGE TYPE) 



and finally <NL> seven times to the language type parameter entry field 
and type in fortran . The language type entry is only required when a new 
Panvalet library member is to be created. 

Now, press the <enter> key . . - 
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Scenario Step 3: Creating/Editing Panvalet member 



and the Panvalet edit data entry panel is displayed. The dots on the left 
indicate new line positions. Now we can begin entering the program into memory. 

Press < F T > at the end of each line . . 


3-32 



Scenario Step 3: Creating/Editing Panvalet member 



and the cursor will move to the far left of the next line. Press the <FT> 


key again . . . 
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Scenario Step 3: Creat i ng/Edi t ing Panvalet member 



and the cursor will move to the first column of the data entry area. 
Continue to type the program into the computer. 

When the last line of the program has been typed <n, press <enter> and . . 
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Scenario Step 3: Creating/Editing Panvalet member 


PVEDIT --- GJZZP.TEST.PAN(TSSAMPLE)- 
COMMAND = s = > 

OOOOOI PROGRAM SAMPLE 


COLUMNS 001 072 
SCROLL ==*> 0018 


000002 CC 
000003 C 
000004 C 
000005 C 
000006 C 
000007 C 


PURPOSE: SHOW THE USE OF THE BASIC SDE CAPABILITIES BY 

WRITING, COMPILING, LINKING AND RUNNING A PROGRAM THAT WILL ASK 
A USER FOR TWO REAL NUMBERS, THEN CALL 2 SUBROUTINES THAT WILL 
COMPUTE AND DISPLAY THEIR SUM, DIFFERENCE, PRODUCT, AND QUOTIENT. 

PROMPT THE USER FOR TWO REAL NUMBERS 


000008 


WR I T E ( 6 , 1000) 

000009 

1000 

FORMAT ( ' ENTER YOUR 

000010 


RE AD ( 5 , 1010) R1 

00001 1 

1010 

FORMAT ( F6 . 2 ) 

000012 

c 


0000 1 3 


WRITE (6 , 2000) 

000014 

2000 

F ORMAT ( ' ENTER YOUR 

000015 


READ( 5 , 1010) R2 

000016 

c 


0000 1 7 


CALL ADD5UB ( R 1 . R2) 

0000 1 8 

c 


0000 1 9 


CALL MULDI V ( R 1 , R2 ) 

000020 

c 


00002 1 


END 


DO THE ADDITION AND SUBTRACTION 
DO THE MULTIPLICATION AND DIVISION 
TERMINATE PROCESSING 


we notice two things have happened. All of the text has been converted to 
upper case, and line numbers have appeared where the dots were. The program 

must now be saved. Press the <end> key . 
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and the Panvalet edit parameter entry panel will be redisplayed. Note 
the message ' TSSAMPLE SAVED' in the upper right corner of the screen. This 
is an example of a short message. 
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Scenario Step 3: Creating/Editing Panvalet member 



Next we want to 
rout ine. T ype 


create the two subroutines that will be 
in the pref ix/name combination t saOdsub , 


cal led by our 


ma i n 
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panvalet edit panel 


TSSAMPLE SAVED 



COMMAND = = *> 

STANDARD PANVALET LIBRARY: 
PROJECT =**> GJZZP 
LIBRARY =**> TEST 
TYPE * = *> PAN 

MEMBER ***> tsaddsub 
NON STANDARD PANVALET LIBRARY: 
PANVALET LIB 
VOLUME SERIAL ***> 

MEMBER SELECTION LIST OPTIONS: 


(IF NOT CATALOGED) 

WITH COMMENTS *> N ( " Y " OR M N" ) 


LIST 

MEMBERS 

STARTING WITH »**> 

LIST 

MEMBERS 

WITH 

LANG TYPE ***> 

LIST 

MEMBERS 

WITH 

USER CODE **=> 

LIST 

MEMBERS 

WITH 

STATUS ***> 

NEW MEMBER OPTIONS: 


LANG 

TYPE * 

«*> ,:ft 

!>p*r*n 

USER 

CODE * 

**> 

(OPTIONAL) 


PANVALET RETRIEVAL OPTIONS: 
CONTROL ***> 

ACCESS 
PROFILE 
INITIAL MACRO 


NOFORMAT *«*> N (Y OR N) 


PAN/TSO *«*> PAN (PAN OR TSO SEQUENCING) 

EXPAND *■«> N (Y OR N) 

(DEFAULTS TO MEMBER LANGUAGE TYPE) 



<NL> seven times to the language type field; type in f or t ran ; and press 
<enter> . . . 
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Scenario Step 3: C reat i ng/ Ed i t i ng Panvalet member 



and we are again in the Panvalet edit data entry mode, 
subroutine just like we did the main routine; press <enter> . 


Type in the 
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Scenario Step 3- Creating/Editing Panvalet member 



and we have our first subroutine finished. 


Press <end> . . 


Scenario Step 3: Creating/Editing Panvalet member 



. and we are back in 
' TS ADDSUB SAVED ' message 


the Panvalet parameter entry panel . 
in the upper right of the panel . 


Note the 
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panvalet edit panel 


T5ADDSUB SAVED 


5TANDARD PANVALET LIBRARY: 
PROJECT *=*> GJZ2P 
LIBRARY «**> TEST 
TYPE »**> PAN 

member =**> 

NON STANDARD PANVALET LIBRARY: 
PANVALET LIB 
VOLUME SERIAL ***> 



MEMBER 

SELECTION LIST OPTIONS: 


LIST 

MEMBERS STARTING WITH 

»« = > 

LIST 

MEMBERS WITH 

LANG TYPE 

■ * «> 

LIST 

MEMBERS WITH 

USER CODE 

***> 

LIST 

MEMBERS WITH 

STATUS 

«**> 

NEW MEMBER OPTIONS: 



LANG 

TYPE ***> 



USER 

CODE **=> 

(OPTIONAL) 


PANVALET RETRIEVAL OPTIONS: 
CONTROL ***> 

ACCESS 

PROFILE -**> 

INITIAL MACRO *«»> 



NOFORMAT 


PAN/TSO **=> PAN 
EXPAND =**> N 


(DEFAULTS TO MEMBER LANGUAGE TYPE) 


Type in the prefix/name combination of the last subroutine, t smu 1 d i v , press 
<enter>, and . . . 
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Scenario Step 3: Creat ing/Edi t ing Panvalet member 



OOPS! the console beeps and we have a message in the short message area. 
It's a new member and we forgot to specify the type. Notice the cursor is 
automatically positioned at the data entry field that is required. 
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Scenario Step 3: Crea t i ng/Ed i t i ng Panvalet member 



COMMAND ***> 

STANDARD PANVALET LIBRARY: 
PROJECT «««> GJZ2P 
LIBRARY ===> TEST 
TYPE *«=*> PAN 

MEMBER ***> TSMULDIV 
NON STANDARD PANVALET LIBRARY 
PANVALET LIB «■*> 

VOLUME SERIAL *=■> 

MEMBER SELECTION LIST OPTIONS 


VERSION - 10. 4A 


(BLANK FOR MEMBER SELECTION LIST) 


(IF NOT CATALOGED) 

WITH COMMENTS «> N ( M Y M OR "N" ) 


LIST 

MEMBERS 

STARTING 

WITH 

* * *> 

LIST 

MEMBERS 

WITH 

LANG 

TYPE 

e**> 

LIST 

MEMBERS 

WITH 

USER 

CODE 

* » *> 

LIST 

MEMBERS 

WITH 

STATUS 

***> 

NEW MEMBER OPT 

IONS : 





LANG TYPE ***> 

USER CODE ***> (OPTIONAL) 

PANVALET RETRIEVAL OPTIONS: 


NOFORMAT *«*> N (Y OR N) 


(PAN OR TSO SEQUENCING) 
(Y OR N) 



Type in fortran ; press <enter> again 
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Scenario Step 3: Creating/Editing Panvalet member 



and we are at the Panvalet edit data entry panel. By now you should have 
no problem typing in the last subroutine. 

Remember that help Is available by typihg 'help' in the 'COMMAND — >' field 
or by pressing <help>. The edit help panels explain all of the bells and 
whistles available to the edit user. 
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Scenario Step 3: Creating/Editing Panvalet member 



Once again, this is what 
<enter> key is pressed, 
panel . . . 


the display looks like when it is typed in and the 
Press <end> to return to the edit parameter entry 
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Scenario Step 3: Creat i ng/ Ed i t i ng Panvalet member 



Note the short message 'TSMULDIV SAVED' and press <end> to go up one level 




Scenario Step 3: Creat i ng/Ech t i ng Panvalet member 



to the Panvalet selection panel. Press <end> to go up one more 


level . . . 
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Scenario Step 3: Creating/Editing Panvalet member 


OPTION = * = > 


0 DEFAULTS 


FDS/SDE PRIMARY OPTION MENU VERSION 2.2 

USERID - GJ22P 

TIME - 15:05 

Specify terminal and user parameters TERMINAL - 3278 
Display source data or output listings PF KEYS “ 24 
Create or change source data 

Perform utility functions (copy, allocate, rename, list) 
Invoke language translators (Asm, Fort, Pascal, GESS) 
Invoke linkage-editor (build load modules) 

Enter TSO command or CLIST 
Perform dialog testing 

Display news or enter comments about ISPF/PDF/SDE 
Use on-line management information systems 
Miscellaneous Software Development Environment Features 
Direct Access data handling utility 
Using SPOOL Display and Search Facility (5DSF) 

. update SDE/SEL Data Base log with ISPF log data 
■ Browse, edit, and utilities for Panvalet data sets 
. Terminate ISPF using log and list defaults 


Enter END command to terminate ISPF. 


to the primary option panel. We have just completed step 3 of our 
scenar i o . 
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Scenario Step 4: Compiling program and subroutines 


FDS/SDE PRIMARY OPTION MENU VERSION 2.2 


USERID - GJZ2P 


• 15:05 


0 DEFAULTS - Specify terminal and user parameters TERMINAL - 3278 


1 BROWSE 


- Display source data or output listings PF KEYS - 24 


2 EDIT 


5 LINK 


- Create or change source data 


3 UTILITIES - Perform utility functions (copy, allocate, rename, list) 

4 COMPILE - Invoke language translators (Asm, Fort, Pascal, GESS) 


- Invoke linkage-editor (build load modules) 


6 TSO 


- Enter TSO command or CLIST 


7 TEST 


- Perform dialog testing 


8 NEWS/VIEWS - Display news or enter comments about ISPF/PDF/SDE 


9 MGT INFO 


- Use on-line management information systems 


10 MISC 


- Miscellaneous Software Development Environment Features 


F FILE AID - Direct Access data handling utility 
JS JOB STATUS - Using SPOOL Display and Search Facility (5DSF ) 


L LOG 


Update SDE/SEL Data Base log with ISPF log data 


P PANVALET 


- Browse, edit, and utilities for Panvalet data sets 


X EXIT 


- Terminate ISPF using log and list defaults 


Enter END command to terminate ISPF. 



Step 4 requires that we compile these three routines. To do this, type 4, then 
<enter> . . . 
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Scenario Step 4: Compiling program and subroutines 



and we arrive at the comp i 1 er/t rans 1 ator function's selection panel. We 
wish to perform a FORTRAN compilation, so . . . 
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Scenario Step 4; Compiling program and subroutines 



type 2, then press <enter>, and . 
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ISPF SOURCE FILE LIBRARY: 

PROJECT «= 

GROUP ***> 

TYPE ***> 

MEMBER ***> 

OTHER PARTITIONED, SEQUENTIAL, or PANVALET DATA SET: 
DATA SET NAME «**> 

PANVALET MEMBER NAME ***> 


COMPILER INCLUDE FILE LIBRARY: 

DATA SET NAME ***> 

ALTERNATE PANVALET INCLUDE FILE LIBRARY: 
DATA SET NAME ***> 



LIST ID =»*> 


COMPILER OPTIONS: 


Automatic Browse? ■**> NO 


the foreground VS FORTRAN compile parameter entry panel is displayed. <NL> 
four times to the DATA SET NAME parameter entry field . . . 
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FOREGROUND VS FORTRAN COMPILE 


COMMAND *==> 

ISPF SOURCE FILE LIBRARY : 

PROJECT ***> 

GROUP ***> 

TYPE *»*> 

MEMBER ***> (Blank for member selection list) 

OTHER PARTITIONED, SEQUENTIAL, or PANVALET DATA SET: 

OATA SET NAME * * * > 

PANVALET MEMBER NAME *■*> MEMBER PREFIX «*«> (optional) 

COMPILER INCLUDE FILE LIBRARY: 

DATA SET NAME *«*> 

ALTERNATE PANVALET INCLUDE FILE LIBRARY: 

DATA SET NAME *«*> 

LIST ID ***> Automatic Browse? **»> NO Automatic Print? = **> NO 

COMPILER OPTIONS: 


* « > 



and type in the name of the Panvalet 1 ibrary (even though our TSO userid 
is GJ2ZP, we are explicitly defining our data set by using quotes). <FT> once to 
the member name field . . 
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Scenario Step 4: Compiling program and subroutines 



and type In the Panvalet member name. SAMPLE. <FT> once more to the 
member prefix field . 
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Scenario Step 4: Compiling program and subroutines 



, . and type in the Panvalet member prefix, TS. The INCLUDE FILES are not 
required, <help> will explain them if you wish to know about them. The listing 
ID will default to the prefix and member name. 

Note that the automatic browse and automatic print answers are both 'NO'. We 
should change this for a first compile. <FT> to these fields 
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Scenario Step 4: Compiling program and subroutines 



and change them both to 'y'. SDE will accept y. ye. or yes in most 
cases; blank defaults to 'NO'. The entries can be in upper or lower case 

Now <FT > to the compiler options field . . . 
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Scenario Step 4: Compiling program and subroutines 



and type in a couple of compiler options. The object module output by the 
compiler will be named 'GJZZP.TS. SAMPLE. OBJ' . Press <enter> and the compile 
will begin. The screen will clear . . . 
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Scenario Step 4; Compiling program and subroutines 



and these messages will be displayed as the compile progresses. A few seconds 
after the VS FORTRAN COMPILER EXITED message is displayed . . . 
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Scenario Step A : Compiling program and subroutines 



. this display will be seen. It is a "browse" of the listing file. Note 
the listing file name has defaulted to the prefix and member as anticipated. 

If you wish you can use <up>, <down>, <left>, or <right> to scroll the display 
w i rdow around the 1 i s t i ng file. The listing file is 132 character!? wide. 



Scenario Step 4: Compiling program and subroutines 


LINE OOOOOO COL 001 080 
SCROLL " = > 0018 


DATE: FEB 26. 1985 


TIME : 


BROWSE - GUZZP.TS. SAMPLE. LIST 

command * = = > f t no error_ 

top of data ** 

LEVEL 1.3.1 (FEB 1984) VS FORTRAN 

REOUESTED OPTIONS (EXECUTE): L I NECOUNT ( 80 ) . XRE F 

OPTIONS IN EFFECT: NOLIST NOMAP XRE F NOGOSTMT NODECK SOURCE TERM OBJECT 

OPT ( 0 ) LANGLVL ( 77 ) NOFIPS FLAG(I) NAME ( MA I N ) LINECOU 

... ....... 1 2 3 4 5 6 

c DATA SET TSSAMPLE AT LEVEL 001 AS OF 02/26/86 

JSN 1 PROGRAM SAMPLE 


PURPOSE: SHOW THE USE OF THE BASIC FDS/SDE CAPABILITIES BY 

WRITING. COMPILING, LINKING AND RUNNING A PROGRAM THAT WILL 
A USER FOR TWO REAL NUMBERS. THEN CALL 2 SUBROUTINES THAT W 
COMPUTE AND DISPLAY THEIR SUM. DIFFERENCE. PRODUCT. AND OUO 

PROMPT THE USER FOR TWO REAL N 

WRITE(6, 1000) 

1000 FORMAT ( ' ENTER YOUR FIRST REAL NUMBER: ' ) 

READ( 5 . 1010) R 1 
1010 FORMAT ( F6 . 2 ) 


WRITE(6. 2000) 

2000 FORMATS ENTER YOUR SECOND REAL NUMBER: ') 


Type 'find error' In the command line field of the display, press <enter> . . 
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Scenario Step 4; Compiling program and subroutines 



. . . and the message NO CHARS 'error' FOUND will appear 
the display. If the word "error" was in the file, as in 
cursor would be positioned at that location in the file, 
lines that are wrong without scanning through the entire 


in the upper right of 
an error message, the 
This lets us see the 
1 i s t i ng . 
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Scenario Step 4: Compiling program and subroutines 


BROWSE - GJZZP . TS . SAMPLE . LIST 
COMMAND = = *> Pbwni •• 


NO CHARS 'error' FOUND 

SCROLL **=> 0018 

*,*»**»««**»»«* »*».,*»*«***«****** TOP OF DATA ************-***** * **“*** ******* * 
LEVEL 1.3.1 (FEB 1984) VS FORTRAN DATE: FEB 26, 1986 TIME: 

REQUESTED OPTIONS (EXECUTE): L INECOUNT ( 80 ) , XRE F 

OPTIONS IN EFFECT: NOLIST NOMAP XREF NOGOSTMT NODECK SOURCE TERM OBJECT 

OPT ( 0 ) L ANGLVL ( 77 ) NOFIPS FLAG(I) NAME ( MA I N ) LINECOU 

....... . . 1 2 3 4 5 6 

C DATA SET TSSAMPLE AT LEVEL 001 AS OF 02/26/86 

ISN 1 PROGRAM SAMPLE 


PURPOSE: SHOW THE USE OF THE BASIC FDS/SDE CAPABILITIES BY 
WRITING, COMPILING, LINKING AND RUNNING A PROGRAM THAT WILL 
A USER FOR TWO REAL NUMBERS, THEN CALL 2 SUBROUTINES THAT W 
COMPUTE AND DISPLAY THEIR SUM, DIFFERENCE, PRODUCT, AND OUO 

PROMPT THE USER FOR TWO REAL N 


ISN 

2 


WRITE ( 6 , 1000) 


ISN 

3 

1000 

FORMAT ( ' ENTER YOUR 

FIRST 

ISN 

4 


RE AD( 5 . 1010) R 1 


ISN 

5 

1010 

FORMAT ( F6 . 2 ) 




c 



ISN 

6 


WR I T E ( 6 , 2000 ) 


ISN 

7 

2000 

F ORMAT ( ' ENTER YOUR 

SECOND 


Type 'down max' in the command line field and press <enter> . . 
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Scenario Step 4: Compiling program and subroutines 



. and we will skip to the bottom of the listing field. In this way we can 
review the processing statistics, in case they flashed by when we weren't 
looking. 


When you are finished scrolling around the listing file, press <end> . . . 
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Scenario Step 4: Compiling program and subroutines 



and the print option panel is displayed. Note the job 
is the same as that which we entered in option O.JC. That's 
f i rst . 


control information 
why we did that 
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Scenario Step 4: Compiling program and subroutines 



Type in the option PK to print and keep the listing data set. We want to keep 
it in order to show you another option later in this scenario. 

Press <enter> and 
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Scenario Step 4: Compiling program and subroutines 



The VS FORTRAN compile parameter entry panel is redisplayed. Note the short 
message in the upper right corner of the display. This message indicates the 
compiler function ended with a return code of zero, meaning no errors were 
found. The next thing to compile is the ADD5UB subroutine, so we position the 
cursor at the Panvalet member name field and . . . 
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Scenario Step 4: Compiling program and subroutines 



. . . type ADDSUB over top of SAMPLE. We will print 
using another option, so <FT> to the automatic print 
entry with the <EEOF> key. All blanks are converted 


the 1 ist 
quest i on 
to NO by 


ng file 1 ater 
and blank out 
the SDE . 


the 


Press <enter> 


St 
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will clear, the messages shown 


ast message . 




Scenario Step 4: Compiling program and subroutines 



we will automatically browse this listing file. Press <end> , and . 
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Scenario Step 4: Compiling program and subroutines 



and the VS FORTRAN compiler parameter entry panel is again displayed. 

Note the short message indicates no errors were found (return code * 0). Object 
module ' G JZZP . TS . ADDSUB . OB J ' (or TS . ADDSUB . OB J ) has been created. 
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Scenario Step 4: Compiling program and subroutines 



Now it's time to create the last object module, TS . MULD I V . OB J . Type in MULDI V 
as the member name, <FT> to the automatic browse question and blank it out; then 
press <enter>. 
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Scenario Step 4; Compiling program and subroutines 



The messages for the compile will be displayed, but this time three asterisks 
will appear at the bottom of the screen. Three asterisks are displayed until 
we acknowledge having seen the results. Press <enter> to acknowledge, and . . 
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FOREGROUND VS FORTRAN COMP I L v ; FUNCTION ENDED RC*0 

COMMAND ***> 

ISPF SOURCE FILE LIBRARY: 

PROJECT **■> 

GROUP * * “ > 

TYPE = * = > 

MEMBER *»*> (Blank for member selection list) 

OTHER PARTITIONED, SEQUENTIAL, or PANVALET DATA SET: 

DATA SET NAME ***> 1GJZZP . TEST . PAN ' 

PANVALET MEMBER NAME ***> MULDIV MEMBER PREFIX ***> T$ (optional) 

COMPILER INCLUDE FILE LIBRARY: 

DATA SET NAME «**> 

ALTERNATE PANVALET INCLUDE FILE LIBRARY: 

DATA SET NAME ”*> 

LIST ID «*=> Automatic Browse? * = = > YES Automatic Print? **«> NO 

COMPILER OPTIONS: 


*«=> LINE COUNT ( 80 ) , XREF 



and the VS FORTRAN compile parameter entry screen is redisplayed. Note by 
the short message that the function once again ended with a return code of 0. 

Boy are we good (actually this scenario was rigged). 

This concludes step 4 of our scenario. Now it's time to learn a handy trick. 


ii 
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Scenario Step 5: Linking program 



What we're going to do is jump directly to the link edit function, without 
pressing <end> to back up to the primary option panel and descending down the 
path to the link edit function. To do this, position the cursor in any input 
field and type in =5 (this means "select option 5 from the primary option 
panel"). Press <enter> . . . 
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Scenario Step 5: Linking program 



1 - Simple Output Load Module (no external references resolved, i.e. NCAL) 


2 - Assembler Source (w/ Utility Libraries) 


3 - VS Fortran Source (w/ Utility and Language Libraries) 


4 - VS Pascal Source (w/ Utility and Language Libraries) 


5 - VS Fortran & VS Pascal Source (w/ Utility and Language Libraries) 


6 - Link Edit with User Defined Output Library 


7 - GESS Driver entry point 



and we scoot to the linkage editor selection panel. This is option 5 
from the primary option panel. We want to build a program using a temporary 
library that we will define, so . . . 
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Scenario Step 5: Linking program 



select option 6 and press <enter>. 
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Scenario Step 5: Linking program 



The user-defined libraries linkage edit parameter entry panel is displayed. 
Note the automatic browse and automatic print answers are the same as we saw 
in the VS FORTRAN compile panel. The answers to these two questions will 
always be retained between functions and between SDE sessions. 


ii 
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Scenario Step 5: Linking program 



<FT> to each position indicated by a shaded area and type in the corresponding 
parameter. The program will be called EXAMPLE and will be saved in a library 
called GJZ2P . TUTORIAL . LOAD . The list ID for link-edits defaults to 
<user i d> . < member name> . LI NKL I ST , GJZZP . EXAMPLE . LINKLIST in this case. 

Press <enter> when finished. The screen will clear, and soon . . . 
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Scenario Step 5: Linking program 



this panel appears. This panel is displayed in response to the V in the 
"Display/Change it" question about the Additional Object Modules List. We want 
to change the list {because there is nothing in it yet). 
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Scenario Step 5: Linking program 



<FT> to position the cursor in the NEW DATA SET NAME field of the panel. Type 
in the name of one of the subroutines and press <enter>. 
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Scenario Step 5: Linking program 



The nai.ie will be converted to all caps and will be entered into the list. The 
cursor will be oositioned in the option field for that member name. 
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Scenario Step 5: Linking program 



Type an R (Repeat) as the option for this list name, press <enter>, and 
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Scenario Step 5: Linking program 



the name will be repeated. Now move the cursor . 


3-84 


Ii 



c 


Scenario Step 5: Linking program 



and type ADDSUB over MULDIV. Press <enter> to update the list, then 
press <end> to continue the link. 
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Scenario Step 5: Linking program 



The screen will clear and soon this message will be displayed. 
In a short tine . . . 
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Scenario Step 5: Linking program 


FOREGROUND LINKAGE EDIT WITH USER DEFIN rUKCT: J ENDED RC*G 


COMMAND *=*> 


LOAD LIBRARY 
MEMBER 


=> TUTORIAL. LOAD 
= > EXAMPLE 


INPUT FILE *■*> TS . SAMPLE . OB J 

PANVALET MEMBER ***> _ 

PANVALET PREFIX ***> 


LIST ID *■*> 


Automatic Browse? **“> NO Automatic Print? ***> NO 


LINKAGE EDITOR OPTIONS: 
■=*> MAP, LIST, LET 


use 

Add i t i ona 1 

Object Modules List? 

***> Y 

D i spl ay /Change 

it? 

■ * e > 

Use 

Addi t iona 1 

Object Libraries List? 

« * * > 

Display/Change 

it? 

■ * *> 

Use 

Addi t i onal 

Load Libraries List? 

■ * * > 

D 1 spl ay /Change 

it? 

* ** > 

Use 

VS FORTRAN 

Libraries? *«*> Y 





Use 

Pascal /VS 

Libraries? ***> 






the link edit parameter entry panel 
should end with a return code of 0, too. 


will be redisplayed. 
We're batting 1000. 


This f unc t i on 
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Scenario Step 5: Linking program 



This completes step 5 of the scenario. Now let's jump to the TSO function to run 
our program. 

Use the <home> key, to put the cursor in the command field. Type in =6 and 
press <enter>. 
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Scenario Step 6: Running program 



Here we are in the TSO command processing function of SDE . We need to allocate 
logical unit 5 for input, logical unit 6 for output, and then fire up the 
program that we have just entered, compiled, and linked. 
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Scenario Step 6: Running program 


t 



To allocate unit 5 to the keyboard for input, we type in this command and press 
<enter> . 
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Scenario Step 6: Running program 



To allocate unit 6 to the display tube for output, move the cursor; change the 5 
to a 6; and press <enter>. 

FT05F001 is the IBM default for logical unit 5, FT06f001 is the IBM default for 
logical unit 6 . 
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To execute our program in the foreground, we type in a call to the library and 
member, and press <enter>. 
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Scenario Step 6: Running program 



Our program will prompt us for a number . 
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Scenario Step 6: Running program 



We type it in. Then our program will prompt us for another number . . . 
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Scenario Step 6: Running program 



Type it in too. After we press <enter> this time . 
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Scenario Step 6: Running program 



Our program will display the results. 

Three asterisks are displayed until we acknowledge having seen the results. 
Press <enter> to acknowledge, and 
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Scenario Step 6: Running program 



the TSO command panel is redisplayed. Press <end>, and . . 
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Scenario Step 7: Printing listing files 


FDS/SDE PRIMARY OPTION MENU VERSION 2.2 


OPTION ***> 


0 DEFAULTS 


1 BROWSE 


2 EDIT 


3 UTILITIES 


4 COMPILE 


5 LINK 


6 TSO 


7 TEST 


USERID - GJZZP 


- 16:30 


- Specify terminal and user parameters TERMINAL - 3276 

* Display source data or output listings PF KEYS - 24 

- Create or change source data 

- Perform utility functions (copy, allocate, rename, list) 

- Invoke language translators (Asm, Fort, Pascal, GESS) 

- Invoke linkage-editor (build load modules) 

- Enter TSO command or CLIST 

- Perform dialog testing 


8 NEWS/VIEWS - Display news or enter comments about ISPF/PDF/SDE 

9 MGT INFO - Use on-line management information systems 


10 MISC 


Miscellaneous Software Development Environment Features 


F FILE AID - Direct Access data handling utility 
JS JOB STATUS - Using SPOOL Display and Search Facility (SDSF) 


L LOG 


P panvalet 


X EXIT 


- update SDE/SEL Data Base log with ISPF log data 

- Browse, edit, and utilities for Panvalet data sets 

- Terminate ISPF using log and list defaults 


Enter END command to terminate ISPF. 




Lo and behold, we ai 


st a few more things 


to do and we can quit. 


As you can see. Utility functions are option 3. Take it on faith that 
listing utilities are utility option 4; and that hardcopy listings are produced 
as listing option 2. Type =3.4.2 in the option input area. This will jump 
option 3 (utilities), suboption 4 (listings), sub- subopt i on 2 (hardcopy). Press 
<enter> . and 
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Scenario Step 7: Printing listing files 



we get to the hardcopy utility parameter entry panel. 
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Scenario Step 7: Printing listing files 



Type in PK for a selection option, then <NL> to the data set name parameter 
entry field. TS . SAMP LE . L I ST is the name of the compile output file. Type it in 
and press <enter>. 


ii 
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Scenario Step 7: Printing listing files 



The short message, JCl GENERATED, is displayed, 
language file has been created and instructions 
have been put into it. The cursor will move to 
name parameter entry field. 


indicating that a job control 
that will print the data set 
the beginning of the data set 
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Scenario Step 7: Printing ‘listing files 



Type in the name of the ADDSUB subroutine and press <enter> . . . 
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Scenario Step 7: Printing listing files 



and the JCL GENERATED message remains. The JCL to print the ADDSUB 
listing file has been added to the file created for SAMPLE. Move the cursor and 
type MULDIV over top of ADDSUB; then press <enter> . . . 
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HARDCOPY UTILITY 


JCL GENERATED 



and instructions to print the MULDIV listing file are added to the UCL 
file. Now move the cursor and add the linkage editor listing file to the list 
of files to be printed. Press <enter> and the JCL GENERATED message remains. 
Press <end> and . . . 


3-104 





and a job submission message is displayed. Three asterisks remain at the 
bottom of the screen until we press <enter> to acknowledge. At that time . . . 
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Scenario Step 8: Updating SDE log and exiting the SDE 



. . . we are back at the primary option panel. 

Type L to select the log update function. This copies our ISPF session log to 
an archive file so the SDE development team can see which options get the most 
use and which ones get the most errors. They will provide more help panels 
and/or redesign functions that generate a lot of error messages. 
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Scenario Step 8: Updating SDE log and exiting the SDE 


OPTION =**> 


FDS/SDE PRIMARY OPTION MENU VERSI SUCCESSFUL 

USERID - GJZ2P 

TIME - 15:42 

Specify terminal and user parameters TERMINAL - 3278 
Display source data or output listings PF KEYS - 24 
Create or change source data 

Perform utility functions (copy, allocate, rename, list) 
Invoke language translators (Asm, Fort, Pascal, GESS) 
Invoke linkage-editor (build load modules) 

Enter TSO command or CLIST 
Perform dialog testing 

Display news or enter comments about ISPF/PDF/SDE 
Use on-line management information systems 
Miscellaneous Software Development Environment Features 
Direct Access data handling utility 
Using SPOOL Display and Search Facility ( SDSF ) 

Update SDE/SEL Data Base log with ISPF log data 
Browse, edit, and utilities for Panvalet data sets 
Terminate ISPF using log and list defaults 


Enter END command to terminate ISPF. 


In a minute or two, the message ARCHIVE SUCCESSFUL will be displayed in the 
short message area. 
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Scenario Step 8: Updating SDE log and exiting the SDE 


OPTION 




FDS/SDE PRIMARY OPTION MENU VERSI 


ARCHIVE SUCCESSFUL 


TIME - 15:42 

- Specify terminal and user parameters TERMINAL - 3278 

- Display source data or output listings PF KEYS - 24 

- Create or change source data 

- Perform utility functions (copy, allocate, rename, list) 

- Invoke language translators (Asm, Fort, Pascal, GESS) 

- Invoke 1 i nkage-ed i tor (build load modules) 

- Enter TSO command or CLIST 

- Perform dialog testing 

- Display news or enter comments about ISPF/PDF/SDE 
• Use on-line management information systems 

- Miscellaneous Software Development Environment Features 

- Direct Access data handling utility 

- Using SPOOL Display and Search Facility (5DSF) 

- Update 5DE/SEL Data Base log with ISPF log data 

- Browse, edit, and utilities for Panvalet data sets 

- Terminate ISPF using log and list defaults 


Enter END command to terminate ISPF. 


Type X as the option to exit. The screen will clear; and soon . . . 
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Scenario Step 8: Updating SDE log and exiting the SDE 



the TSO READY acknowledgement will appear. Now, type in logoff and you 
wni b e off the system. Best of luck in your software development adventures 
. aided by the SDE. 
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